.TH "OSM2PGSQL" "1" "2.2.0" "" ""
.SH NAME
osm2pgsql\-gen \- Generalize OpenStreetMap data \- EXPERIMENTAL!
.SH SYNOPSIS
\f[B]osm2pgsql\-gen\f[R] [\f[I]OPTIONS\f[R]]\&...
.SH DESCRIPTION
THIS PROGRAM IS EXPERIMENTAL AND MIGHT CHANGE WITHOUT NOTICE!
.PP
\f[B]osm2pgsql\-gen\f[R] reads data imported by \f[B]osm2pgsql\f[R] from
the database, performs various generalization steps specified by a Lua
config file and writes the data back to the database.
It is used in conjunction with and after \f[B]osm2pgsql\f[R] and reads
the same config file.
.PP
This man page can only cover some of the basics and describe the command
line options.
See the \c
.UR https://osm2pgsql.org/doc/manual.html#generalization
Generalization chapter in the osm2pgsql Manual
.UE \c
\ for more information.
.SH OPTIONS
This program follows the usual GNU command line syntax, with long
options starting with two dashes (\f[CR]\-\-\f[R]).
Mandatory arguments to long options are mandatory for short options too.
.SH MAIN OPTIONS
.TP
\-a, \-\-append
Run in append mode.
The default is to run in create mode.
.TP
\-S, \-\-style=FILE
The Lua config file.
Same as for \f[B]osm2pgsql\f[R].
Usually not required because it is read from the
\f[CR]osm2pgsql_properties\f[R] table.
.TP
\-j, \-jobs=NUM
Specifies the number of parallel threads used for certain operations.
Setting this to the number of available CPU cores is a reasonable
starting point.
Minimum value and default is 1, maximum value is 256.
.SH HELP/VERSION OPTIONS
.TP
\-h, \-\-help
Print help.
.TP
\-V, \-\-version
Print osm2pgsql version.
.SH LOGGING OPTIONS
.TP
\-\-log\-level=LEVEL
Set log level (`debug', `info' (default), `warn', or `error').
.TP
\-\-log\-sql
Enable logging of SQL commands for debugging.
.SH DATABASE OPTIONS
.TP
\-d, \-\-database=NAME
The name of the PostgreSQL database to connect to.
If this parameter contains an \f[CR]=\f[R] sign or starts with a valid
URI prefix (\f[CR]postgresql://\f[R] or \f[CR]postgres://\f[R]), it is
treated as a conninfo string.
See the PostgreSQL manual for details.
.TP
\-U, \-\-username=NAME
Postgresql user name.
.TP
\-W, \-\-password
Force password prompt.
.TP
\-H, \-\-host=HOSTNAME
Database server hostname or unix domain socket location.
.TP
\-P, \-\-port=PORT
Database server port.
.TP
\-\-schema=SCHEMA
Default for various schema settings throughout osm2pgsql\-gen (default:
\f[CR]public\f[R]).
The schema must exist in the database and be writable by the database
user.
It must be the same as used with \f[CR]osm2pgsql\f[R].
.TP
\-\-middle\-schema=SCHEMA
Database schema where the \f[CR]osm2pgsql_properties\f[R] table is to be
found.
Default set with \f[CR]\-\-schema\f[R].
Set to the same value as on the \f[CR]osm2pgsql\f[R] command line.
.SH SEE ALSO
.IP \[bu] 2
\c
.UR https://osm2pgsql.org
osm2pgsql website
.UE \c
.IP \[bu] 2
\c
.UR https://osm2pgsql.org/doc/manual.html
osm2pgsql manual
.UE \c
.IP \[bu] 2
\f[B]postgres\f[R](1)
.IP \[bu] 2
\f[B]osm2pgsql\f[R](1)
